<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkToolbar</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="MenusAndCombos.html" title="菜单、组合框和工具栏">
<link rel="prev" href="gtk3-GtkToolShell.html" title="GtkToolShell">
<link rel="next" href="gtk3-GtkToolItem.html" title="GtkToolItem">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkToolShell.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkToolItem.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkToolbar.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkToolbar.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkToolbar"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkToolbar.top_of_page"></a>GtkToolbar</span></h2>
<p>GtkToolbar — Create bars of buttons and other widgets</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkToolbar.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar">GtkToolbar</a>;
enum                <a class="link" href="gtk3-GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</a>;
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-new" title="gtk_toolbar_new ()">gtk_toolbar_new</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()">gtk_toolbar_insert</a>                  (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-item-index" title="gtk_toolbar_get_item_index ()">gtk_toolbar_get_item_index</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-n-items" title="gtk_toolbar_get_n_items ()">gtk_toolbar_get_n_items</a>             (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-nth-item" title="gtk_toolbar_get_nth_item ()">gtk_toolbar_get_nth_item</a>            (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-drop-index" title="gtk_toolbar_get_drop_index ()">gtk_toolbar_get_drop_index</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-drop-highlight-item" title="gtk_toolbar_set_drop_highlight_item ()">gtk_toolbar_set_drop_highlight_item</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-show-arrow" title="gtk_toolbar_set_show_arrow ()">gtk_toolbar_set_show_arrow</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_arrow</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-unset-icon-size" title="gtk_toolbar_unset_icon_size ()">gtk_toolbar_unset_icon_size</a>         (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-show-arrow" title="gtk_toolbar_get_show_arrow ()">gtk_toolbar_get_show_arrow</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>     <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-style" title="gtk_toolbar_get_style ()">gtk_toolbar_get_style</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-icon-size" title="gtk_toolbar_get_icon_size ()">gtk_toolbar_get_icon_size</a>           (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-get-relief-style" title="gtk_toolbar_get_relief_style ()">gtk_toolbar_get_relief_style</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()">gtk_toolbar_set_style</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()">gtk_toolbar_set_icon_size</a>           (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-unset-style" title="gtk_toolbar_unset_style ()">gtk_toolbar_unset_style</a>             (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkToolbar.description"></a><h2>Description</h2>
<p>
A toolbar is created with a call to <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-new" title="gtk_toolbar_new ()"><code class="function">gtk_toolbar_new()</code></a>.
</p>
<p>
A toolbar can contain instances of a subclass of <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a>. To add
a <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> to the a toolbar, use <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a>. To remove
an item from the toolbar use <a class="link" href="gtk3-GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a>. To add a button
to the toolbar, add an instance of <a class="link" href="gtk3-GtkToolButton.html#GtkToolButton" title="struct GtkToolButton"><span class="type">GtkToolButton</span></a>.
</p>
<p>
Toolbar items can be visually grouped by adding instances of
<a class="link" href="gtk3-GtkSeparatorToolItem.html#GtkSeparatorToolItem" title="struct GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a> to the toolbar. If the GtkToolbar child property
"expand" is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> and the property <span class="type">"draw"</span> is set to
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, the effect is to force all following items to the end of the toolbar.
</p>
<p>
Creating a context menu for the toolbar can be done by connecting to
the <span class="type">"popup-context-menu"</span> signal.
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkToolbar.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkToolbar"></a><h3>struct GtkToolbar</h3>
<pre class="programlisting">struct GtkToolbar {
  GtkContainer container;

  GtkToolbarPrivate *priv;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbarSpaceStyle"></a><h3>enum GtkToolbarSpaceStyle</h3>
<pre class="programlisting">typedef enum {
  GTK_TOOLBAR_SPACE_EMPTY,
  GTK_TOOLBAR_SPACE_LINE
} GtkToolbarSpaceStyle;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-new"></a><h3>gtk_toolbar_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_new                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Creates a new toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the newly-created toolbar.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert"></a><h3>gtk_toolbar_insert ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_insert                  (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>);</pre>
<p>
Insert a <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> into the toolbar at position <em class="parameter"><code>pos</code></em>. If <em class="parameter"><code>pos</code></em> is
0 the item is prepended to the start of the toolbar. If <em class="parameter"><code>pos</code></em> is
negative, the item is appended to the end of the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
<td>the position of the new item</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-item-index"></a><h3>gtk_toolbar_get_item_index ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_item_index          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>);</pre>
<p>
Returns the position of <em class="parameter"><code>item</code></em> on the toolbar, starting from 0.
It is an error if <em class="parameter"><code>item</code></em> is not a child of the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> that is a child of <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the position of item on the toolbar.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-n-items"></a><h3>gtk_toolbar_get_n_items ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_n_items             (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Returns the number of items on the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the number of items on the toolbar</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-nth-item"></a><h3>gtk_toolbar_get_nth_item ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_toolbar_get_nth_item            (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);</pre>
<p>
Returns the <em class="parameter"><code>n</code></em>'th item on <em class="parameter"><code>toolbar</code></em>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the
toolbar does not contain an <em class="parameter"><code>n</code></em>'th item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
<td>A position on the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The <em class="parameter"><code>n</code></em>'th <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> on <em class="parameter"><code>toolbar</code></em>,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there isn't an <em class="parameter"><code>n</code></em>'th item. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-drop-index"></a><h3>gtk_toolbar_get_drop_index ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_drop_index          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
<p>
Returns the position corresponding to the indicated point on
<em class="parameter"><code>toolbar</code></em>. This is useful when dragging items to the toolbar:
this function returns the position a new item should be
inserted.
</p>
<p>
<em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> are in <em class="parameter"><code>toolbar</code></em> coordinates.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td>x coordinate of a point on the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
<td>y coordinate of a point on the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The position corresponding to the point (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) on the toolbar.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-drop-highlight-item"></a><h3>gtk_toolbar_set_drop_highlight_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_drop_highlight_item (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);</pre>
<p>
Highlights <em class="parameter"><code>toolbar</code></em> to give an idea of what it would look like
if <em class="parameter"><code>item</code></em> was added to <em class="parameter"><code>toolbar</code></em> at the position indicated by <em class="parameter"><code>index_</code></em>.
If <em class="parameter"><code>item</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, highlighting is turned off. In that case <em class="parameter"><code>index_</code></em> 
is ignored.
</p>
<p>
The <em class="parameter"><code>tool_item</code></em> passed to this function must not be part of any widget
hierarchy. When an item is set as drop highlight item it can not
added to any widget hierarchy or used as highlight item for another
toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to turn of highlighting. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
<td>a position on <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-show-arrow"></a><h3>gtk_toolbar_set_show_arrow ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_show_arrow          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_arrow</code></em>);</pre>
<p>
Sets whether to show an overflow menu when
<em class="parameter"><code>toolbar</code></em> doesn't have room for all items on it. If <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
items that there are not room are available through an
overflow menu.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>show_arrow</code></em> :</span></p></td>
<td>Whether to show an overflow menu</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-unset-icon-size"></a><h3>gtk_toolbar_unset_icon_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_unset_icon_size         (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Unsets toolbar icon size set with <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()"><code class="function">gtk_toolbar_set_icon_size()</code></a>, so that
user preferences will be used to determine the icon size.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-show-arrow"></a><h3>gtk_toolbar_get_show_arrow ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_toolbar_get_show_arrow          (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Returns whether the toolbar has an overflow menu.
See <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-show-arrow" title="gtk_toolbar_set_show_arrow ()"><code class="function">gtk_toolbar_set_show_arrow()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the toolbar has an overflow menu.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-style"></a><h3>gtk_toolbar_get_style ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>     gtk_toolbar_get_style               (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Retrieves whether the toolbar has text, icons, or both . See
<a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()"><code class="function">gtk_toolbar_set_style()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current style of <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-icon-size"></a><h3>gtk_toolbar_get_icon_size ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         gtk_toolbar_get_icon_size           (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Retrieves the icon size for the toolbar. See <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()"><code class="function">gtk_toolbar_set_icon_size()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current icon size for the icons on
the toolbar. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> int]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-relief-style"></a><h3>gtk_toolbar_get_relief_style ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      gtk_toolbar_get_relief_style        (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Returns the relief style of buttons on <em class="parameter"><code>toolbar</code></em>. See
<a class="link" href="gtk3-GtkButton.html#gtk-button-set-relief" title="gtk_button_set_relief ()"><code class="function">gtk_button_set_relief()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The relief style of buttons on <em class="parameter"><code>toolbar</code></em>.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-style"></a><h3>gtk_toolbar_set_style ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_style               (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style</code></em>);</pre>
<p>
Alters the view of <em class="parameter"><code>toolbar</code></em> to display either icons only, text only, or both.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
<td>the new style for <em class="parameter"><code>toolbar</code></em>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-icon-size"></a><h3>gtk_toolbar_set_icon_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_icon_size           (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
<p>
This function sets the size of stock icons in the toolbar. You
can call it both before you add the icons and after they've been
added. The size you set will override user preferences for the default
icon size.
</p>
<p>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon_size</code></em> :</span></p></td>
<td>The <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> that stock icons in the
toolbar shall have. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> int]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-unset-style"></a><h3>gtk_toolbar_unset_style ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_unset_style             (<em class="parameter"><code><a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Unsets a toolbar style set with <a class="link" href="gtk3-GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()"><code class="function">gtk_toolbar_set_style()</code></a>, so that
user preferences will be used to determine the toolbar style.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkToolbar.html#GtkToolbar" title="struct GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="gtk3-GtkToolbar.see-also"></a><h2>See Also</h2>
<a class="link" href="gtk3-GtkToolItem.html#GtkToolItem" title="struct GtkToolItem"><span class="type">GtkToolItem</span></a>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>